home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _graphics / graphics / _aim / aim / addman300 next >
Encoding:
Text File  |  1993-11-16  |  4.7 KB  |  122 lines
  1. New commands (related to version 2.10), as per November 1993:
  2.  
  3. ******** version 2.20
  4.  
  5. In version 2.20 of AIM/2 a command 'affine' is added.
  6.  
  7. This command can be applied to 'map' an image such as a satellite picture
  8. to a cartographic map of the same area. Identical points are indicated
  9. by the mouse. Although three pair of points are sufficient to define the
  10. mapping, four pair of points are required as a minimum input.
  11. In a less serious application, affine can be used to transform or distort
  12. an image (e.g. changing TRUI's face).
  13.  
  14. Add this text to the Reference Manual, Chapter 5, Additional Operations:
  15.  
  16. 5.1 Specials
  17.  
  18. affine (*) : maps an input image to an output image
  19.  
  20. Affine asks for a number of pairs of points to be indicated with the mouse.
  21. Each pair consists of a point in the 'input' image and a point in the
  22. 'reference' image. The 'output' image is the resulting image.
  23. After at least four pairs have been indicated, <RETURN> stops asking for
  24. more inputs (mouse-clicks) and causes that the best transform which maps
  25. the input points onto the reference points is calculated. Then, the input
  26. image is transformed to the output image using this transform.
  27. Remarks:
  28. - <ESC> cancels points.
  29. - the output image must not be the input image.
  30.  
  31. command :  affine  in_image,  out_image,  ref_image
  32. default :  affine      A   ,      B    ,      D
  33. range   :            <A-D> ,    <A-D>  ,    <A-D>
  34.  
  35. ********* version 3.00
  36.  
  37. In AIM/3, version 3.00, the use of the Select-button in the affine command
  38. is in conflict with the Image Editing functions as described below.
  39. Hence, in 3.00 you have to use the Menu-button for clicking the points.
  40. As a side-effect you get the AIM-menu popped-up every time you press the
  41. Menu-button. Just ignore this.
  42. When using image A as the input and D as the reference image (default),
  43. be sure you have the display-windows of A and D alongside each other and
  44. with some distance in between. So the 'side-effect' pop-up menu will not
  45. mask the second window.
  46.  
  47. ***
  48.  
  49. Add this text to the Reference Manual, section 5, Additional Operations:
  50.  
  51. 5.2 Image Editing
  52.  
  53. making a selection, the selectmenu
  54.  
  55. A (rectangular) portion of a displayed image can be selected by clicking
  56. the Select-button while the mouse-pointer is at the top-left position of
  57. that portion and by 'dragging' the mouse-pointer to the bottom-right
  58. position. A 'rubberbox' is shown.
  59. At the release of the Select button, a information-box pops-up, allowing
  60. the modification of the top-left and bottom-right positions by typing the
  61. co-ordinates. When using the mouse, the smallest rectangle is 48x48 pixels,
  62. by typing the co-ordinates ('up to and including'), a smaller size may be
  63. achieved. The information-box disappears by clicking the OK button.
  64. The displaywindow with the red rectangle is now in - what might be called -
  65. a 'state of selection': clicking 'Menu' is not showing the usual AIM menu,
  66. but pops-up a special selectmenu with the entries <clear>, <select>,
  67. <copy> and <save>.
  68.  
  69. selectmenu: clear, select
  70.  
  71. Clicking at the entry 'clear' is finishing the 'state of selection'.
  72. Clicking at 'select' pops-up the information-box.
  73.  
  74. selectmenu: copy, save
  75.  
  76. The selection can be copied to an open AIM display-window, resulting in a
  77. new image in memory. This (smaller in size) image may be processed as usual.
  78. Alternatively, the selection can be saved to a filer-window or directly
  79. copied into an open application, e.g. as a GreySprite into the application
  80. !Sprite.
  81.  
  82. Note:
  83. The sizes of the selected portion are truncated to modulo-4 measures.
  84.  
  85. Related operations as 'pasting' and 'merging' may be expected in future
  86. releases.
  87.  
  88. ***
  89.  
  90. In AIM/3 the TCL-Image datafile is accepted.
  91. Add to the Reference Manual, section 6 Appendices:
  92.  
  93. 6.1.2 TCL header
  94.  
  95. The first 512 bytes of the TCL datafile form the 'header'.
  96. The first 32 (16 bit) words of it, contain information about the data in
  97. the file, the next 224 words contain user data (numerical) and descriptive
  98. text (ASCII).
  99.  
  100. 16b word # Contents
  101.  
  102. 1       0  if the file contains 16b pixels, 'unpacked'.
  103.         1  if the file contains 8b pixels, 'packed' in pairs into 16b words.
  104. 2       The number of elements in a line of the image.
  105. 3       The number of lines in the image.
  106. 4       The file-sequence number on the tape, starting with 1.
  107.         On disk files this entry is 0.
  108. 5       The number of bits per pixel:
  109.         5  :   5 bits greyvalue + 3 bits overlay colours
  110.         8  :   8 bits greyvalue
  111.         16: 16 bits greyvalue
  112. 6-32    Reserved for future use.
  113.  
  114. 33-128  User numerical data
  115. 129-204 User text
  116. 205-219 Creation date of the file
  117. 220-256 Description text
  118.  
  119. ********** The modified Users Manual (revision 1) is available  *********
  120. ********** for a complete information 'update' and contains the *********
  121. ********** modified pages of the Reference Manual as well.      *********
  122.